IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/a_man/cat1/csarun.z/csarun

Text File | 2001-04-17 | 16.8 KB | 265 lines

ccccssssaaaarrrruuuunnnn((((1111MMMM))))                                                          ccccssssaaaarrrruuuunnnn((((1111MMMM))))



NNNNAAAAMMMMEEEE
     csarun - processes the daily accounting files and generates reports

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_rrrr_uuuu_nnnn [_----_AAAA] [_----_VVVV _l_e_v_e_l] [_M_M_D_D [_h_h_m_m [_s_t_a_t_e]]]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The _cccc_ssss_aaaa_rrrr_uuuu_nnnn command, usually initiated by _cccc_rrrr_oooo_nnnn(1M), directs the processing
     of the daily accounting files.  _cccc_ssss_aaaa_rrrr_uuuu_nnnn processes accounting records
     written into the _p_a_c_c_t file.

     If errors occur, _cccc_ssss_aaaa_rrrr_uuuu_nnnn does not damage the active accounting file.  It
     records its progress by writing descriptive diagnostic messages to the
     _aaaa_cccc_tttt_iiii_vvvv_eeee file.  When an error is detected, a message is written to the
     SYSLOG file, and mail is sent to _rrrr_oooo_oooo_tttt and _aaaa_dddd_mmmm.  Further data processing
     is halted.

     Before invoking _cccc_ssss_aaaa_rrrr_uuuu_nnnn on a new accounting period, ensure that the
     previous invocation of _cccc_ssss_aaaa_rrrr_uuuu_nnnn has completed successfully.  If this is not
     done, information about unfinished jobs will not be accurate.

     The _llll_oooo_cccc_kkkk and _llll_oooo_cccc_kkkk_1111 files are used to protect against simultaneous
     invocation.

     The _cccc_ssss_aaaa_rrrr_uuuu_nnnn command accepts the following options and operands:

     _----_AAAA        Accounts for both terminated and active jobs.  By default, only
               terminated jobs are reported.  _cccc_ssss_aaaa_rrrr_uuuu_nnnn does not recycle active
               jobs when this option is specified.

     _----_VVVV _l_e_v_e_l  Controls verification level of accounting data files.

     _M_M_D_D [_h_h_m_m [_s_t_a_t_e]]
               Sets month, day, hour, minute, and state for which _cccc_ssss_aaaa_rrrr_uuuu_nnnn will
               rerun the accounting.  If _cccc_ssss_aaaa_rrrr_uuuu_nnnn is restarted, the month and
               day are necessary; other portions are optional.  If you supply
               the _s_t_a_t_e on the command line, you must also specify _h_h_m_m.

     The _cccc_ssss_aaaa_rrrr_uuuu_nnnn command breaks its processing into separate, restartable
     states using _ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee to remember the last state completed.  It
     accomplishes this by writing the state name into _ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee.  _cccc_ssss_aaaa_rrrr_uuuu_nnnn looks
     in _ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee to determine what must be processed next.  The states are
     executed in the following order:

     SSSSttttaaaatttteeee NNNNaaaammmmeeee     DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn

     _SSSS_EEEE_TTTT_UUUU_PPPP          Moves active accounting files into a work directory.

     _VVVV_EEEE_RRRR_IIII_FFFF_YYYY         Verifies the integrity of the data files.






                                                                        PPPPaaaaggggeeee 1111






ccccssssaaaarrrruuuunnnn((((1111MMMM))))                                                          ccccssssaaaarrrruuuunnnn((((1111MMMM))))



     _AAAA_RRRR_CCCC_HHHH_IIII_VVVV_EEEE_1111       User exit that executes a site-generated accounting script
                    to archive the accounting files.

     _BBBB_UUUU_IIII_LLLL_DDDD          Organizes the accounting data into a _ssss_oooo_rrrr_tttt_eeee_dddd _pppp_aaaa_cccc_cccc_tttt file.

     _AAAA_RRRR_CCCC_HHHH_IIII_VVVV_EEEE_2222       User exit that executes a site-generated accounting script
                    to archive the _ssss_oooo_rrrr_tttt_eeee_dddd _pppp_aaaa_cccc_cccc_tttt file.

     _CCCC_MMMM_SSSS            Generates command summaries.

     _RRRR_EEEE_PPPP_OOOO_RRRR_TTTT         Generates daily accounting reports.

     _DDDD_RRRR_EEEE_PPPP           Generates daemon usage report.

     _FFFF_EEEE_FFFF            User exit that executes a site-generated accounting script
                    to format the _ssss_oooo_rrrr_tttt_eeee_dddd _pppp_aaaa_cccc_cccc_tttt file into a format that is
                    suitable for use on a front end.

     _UUUU_SSSS_EEEE_RRRR_EEEE_XXXX_IIII_TTTT       User exit that executes a site-generated accounting
                    script.

     _CCCC_LLLL_EEEE_AAAA_NNNN_UUUU_PPPP        Cleans up temporary files and exits.

     Before restarting _cccc_ssss_aaaa_rrrr_uuuu_nnnn after a failure, check the _aaaa_cccc_tttt_iiii_vvvv_eeee file for
     diagnostics, then fix any corrupted _p_a_c_c_t files.  The lock files must be
     removed before _cccc_ssss_aaaa_rrrr_uuuu_nnnn can be restarted.  If _cccc_ssss_aaaa_rrrr_uuuu_nnnn is restarted, you must
     specify the _M_M_D_D operand, which specifies the month and day for which
     _cccc_ssss_aaaa_rrrr_uuuu_nnnn will rerun the accounting.  The entry point for processing is
     based on the contents of _ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee.  To override this entry point,
     include the desired state on the command line to designate where
     processing should begin.

NNNNOOOOTTTTEEEESSSS
     The mail recipients (_rrrr_oooo_oooo_tttt and _aaaa_dddd_mmmm) can be changed by modifying the
     _MMMM_AAAA_IIII_LLLL______LLLL_IIII_SSSS_TTTT  and _WWWW_MMMM_AAAA_IIII_LLLL______LLLL_IIII_SSSS_TTTT parameters in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.  You also
     can change the other parameters defined in the accounting configuration
     file for your site.

     _cccc_ssss_aaaa_rrrr_uuuu_nnnn checks the number of free blocks in the filesystem that contains
     the accounting files to ensure that it consists of more than 2000 blocks.
     Block size is 1024 bytes.  By default, _cccc_ssss_aaaa_rrrr_uuuu_nnnn assumes that the filesystem
     is _////_vvvv_aaaa_rrrr; if this is not the case, change symbol _AAAA_CCCC_CCCC_TTTT______FFFF_SSSS in _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff
     accordingly.  To change the minimum number of free blocks on _AAAA_CCCC_CCCC_TTTT______FFFF_SSSS (the
     default is 2000), modify _MMMM_IIII_NNNN______BBBB_LLLL_KKKK_SSSS in the configuration file.

     To remove bad records in accounting data files encountered by _cccc_ssss_aaaa_rrrr_uuuu_nnnn, use
     _cccc_ssss_aaaa_eeee_dddd_iiii_tttt(1M) and _cccc_ssss_aaaa_vvvv_eeee_rrrr_iiii_ffff_yyyy(1M).

     You need to make sure that _cccc_ssss_aaaa_rrrr_uuuu_nnnn can read the site-generated user exit
     scripts.  If _cccc_ssss_aaaa_rrrr_uuuu_nnnn cannot read the scripts, it does not handle the error
     graciously like it does for other errors.  This means the error will not
     be logged in the SYSLOG file and the active file, and no notification



                                                                        PPPPaaaaggggeeee 2222






ccccssssaaaarrrruuuunnnn((((1111MMMM))))                                                          ccccssssaaaarrrruuuunnnn((((1111MMMM))))



     email will be sent out.

BBBBUUUUGGGGSSSS
     If possible, do not restart _cccc_ssss_aaaa_rrrr_uuuu_nnnn in the SETUP state.  Instead, run
     SETUP manually and restart _cccc_ssss_aaaa_rrrr_uuuu_nnnn by using the following command line:

          _cccc_ssss_aaaa_rrrr_uuuu_nnnn _M_M_D_D _h_h_m_m VERIFY

     If _cccc_ssss_aaaa_rrrr_uuuu_nnnn terminates abnormally and leaves the lock files in place, the
     next execution of _cccc_ssss_aaaa_rrrr_uuuu_nnnn will remove these locks, but it also will
     terminate abnormally.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     Example 1:  The following example shows how to start _cccc_ssss_aaaa_rrrr_uuuu_nnnn:

          _nnnn_oooo_hhhh_uuuu_pppp _cccc_ssss_aaaa_rrrr_uuuu_nnnn _2222_>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_ffff_dddd_2222_llll_oooo_gggg _&&&&

     Example 2:  The following example shows how to restart _cccc_ssss_aaaa_rrrr_uuuu_nnnn at the
     state specified in _ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee:

          _nnnn_oooo_hhhh_uuuu_pppp _cccc_ssss_aaaa_rrrr_uuuu_nnnn _0000_6666_0000_1111 _1111_3333_4444_5555 _2222_>>>>_>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_ffff_dddd_2222_llll_oooo_gggg _&&&&

     Example 3:  The following example shows how to restart _cccc_ssss_aaaa_rrrr_uuuu_nnnn at a
     specific state:

          _nnnn_oooo_hhhh_uuuu_pppp _cccc_ssss_aaaa_rrrr_uuuu_nnnn _0000_6666_0000_1111 _1111_3333_4444_5555 _BBBB_UUUU_IIII_LLLL_DDDD _2222_>>>>_>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_ffff_dddd_2222_llll_oooo_gggg _&&&&

FFFFIIIILLLLEEEESSSS
     _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff                      Accounting configuration file

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_****                Directory that contains current
                                        accounting files

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_aaaa_cccc_tttt_iiii_vvvv_eeee      Record of accounting progress

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_cccc_llll_aaaa_ssss_tttt_dddd_aaaa_tttt_eeee   Record of last date and time that
                                        accounting ran

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_llll_oooo_cccc_kkkk        Lock file that prevents simultaneous
                                        invocation

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_llll_oooo_cccc_kkkk_1111       Lock file that prevents simultaneous
                                        invocation

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_cccc_ssss_aaaa_////_ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee   Record of last state that _cccc_ssss_aaaa_rrrr_uuuu_nnnn was
                                        working on or completed

     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa_////_****            Directory that contains daily
                                        condensed data files and accounting
                                        reports





                                                                        PPPPaaaaggggeeee 3333






ccccssssaaaarrrruuuunnnn((((1111MMMM))))                                                          ccccssssaaaarrrruuuunnnn((((1111MMMM))))



     _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_wwww_oooo_rrrr_kkkk_////_****               Directory that contains temporary
                                        files from daily accounting

     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._aaaa_rrrr_cccc_hhhh_iiii_vvvv_eeee_1111         Site-generated user exit script to be
                                        executed during the _AAAA_RRRR_CCCC_HHHH_IIII_VVVV_EEEE_1111 state.

     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._aaaa_rrrr_cccc_hhhh_iiii_vvvv_eeee_2222         Site-generated user exit script to be
                                        executed during the _AAAA_RRRR_CCCC_HHHH_IIII_VVVV_EEEE_2222 state.

     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._ffff_eeee_ffff              Site-generated user exit script to be
                                        executed during the _FFFF_EEEE_FFFF state.

     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_...._uuuu_ssss_eeee_rrrr             Site-generated user exit script to be
                                        executed during the _UUUU_SSSS_EEEE_RRRR_EEEE_XXXX_IIII_TTTT state.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     cron(1M), csaaddc(1M), csabuild(1M), csacms(1M), csacon(1M), csacrep(1M),
     csadrep(1M), csaedit(1M), csajrep(1M), csaperiod(1M), csarecy(1M),
     csaverify(1M), acctctl(3c).




































                                                                        PPPPaaaaggggeeee 4444